home *** CD-ROM | disk | FTP | other *** search
/ Over 1,000 Windows 95 Programs / Over 1000 Windows 95 Programs (Microforum) (Disc 1).iso / 1245 / pstruc.doc < prev    next >
Text File  |  1997-04-18  |  4KB  |  70 lines
  1.                     How to use the program PSTRUC
  2.  
  3.  
  4.  
  5. The program has only two functions. The first function generates a print file,
  6. named UNUSEDPA, to mean unused paragraphs and the second one creates the
  7. print file, named ORGCHARP, which contains the structure chart. You may
  8. have defined paragraphs which may or may not contain lines and you may have
  9. forgotton that you no longer use them. In other words, they are
  10. not PERFROMED from anywhere from within your source program. So, by
  11. generating this print file, you may see these paragraphs, if any, and
  12. decide to keep them or to eliminate them. Attention! The paragraphs
  13. called from within DECLARATIVES appear as if they were called from
  14. nowhere from within the program so make sure to distinguish them
  15. and do not eliminate them by mistake. This is a current limitation
  16. of the program PSTRUC. Attention again! PSTRUC requires that the
  17. highest level paragraph, right after the PROCEDURE DIVISION, be
  18. prefixed A000. You may chose paragraph prefixes for all the other
  19. paragraphs to your heart's wish so long as they are four-digit long
  20. and they are unique. PSTRUC will flag out any duplicate paragraph
  21. prefixes so you can concentrate yourself on the real job rather
  22. than on this detail. After all, if you have, by mistake, used the
  23. same paragraph prefix more than once, you just change it and continue
  24. doing the work.
  25.  
  26. The second function of the program is the most important one. It
  27. creates the ORGCHARP. It is a print file which contains the structure
  28. chart of your program in an indented list form. You can consult it with
  29. an ASCII text editor or send out to the printer for a hardcopy.
  30.  
  31. You need to rename your source file as ISOURCE.CBL and place it
  32. in the working directory of the program PSTRUC. PSTRUCT creates
  33. and uses a couple of files to accomplish its internal work. So,
  34. do not pay attention to these files. However, the one, named OSOURCE.CBL,
  35. is important. PSTRUCT creates OSOURCE.CBL as an output file which
  36. is basically same as your original program source file (ISOURCE.CBL) but
  37. its order is changed when necessary. OSOURCE.CBL rearranges your
  38. original source program in logical call order. So, if the pyhsical
  39. call order of paragraphs in your source program do not correspond
  40. to the logical order of your program, you may use the OSOURCE.CBL.
  41. You just eliminate your original source file and rename OUSOURCE.CBL
  42. to be your original source file. When you read the source code, it
  43. is nice to see that each PERFORMED paragraph follows right afterwards
  44. so that you do not tire yourself too much by jumping around in the source
  45. file in an effort to find where the performed paragraph is located.
  46. The only exception to this is those paragraphs which are PERFORMED
  47. several times throughout the program source file. In that case, the
  48. paragraph will appear right after the first paragraph wherefrom it
  49. is performed.
  50.  
  51. This shareware utility program for COBOL programmers can be distributed
  52. without limitations.
  53.  
  54. After having tried this shareware program, for regular use, please send
  55. check or money order of US$ 20.00 to:
  56.  
  57. Enver DEMIRTAS
  58. Custom Business Software Development
  59. 2, bd St-Georges
  60. P.O. Box 214
  61. 1211 Geneva / Swizlerland
  62.  
  63. After reception of your payment, you will be registered as a licenced user
  64. and you will get regular updates and support from the author.
  65.  
  66. The author can be contacted at the above address or thru:
  67.  
  68. Voice/fax: 041 022 329 53 30
  69. Email: edemirtas@automail.com
  70.